home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / telecomm / 378 / hagtrm33 / hagscrpt.txt next >
Text File  |  1978-02-04  |  64KB  |  2,443 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                           HagTerm Elite
  15.                          HagScript Manual
  16.                       ---------------------
  17.  
  18.  
  19.                          by Hagop Janoyan
  20.                          Version 3.1 Beta
  21.  
  22.  
  23.                 Officially Released November 1989
  24.  
  25.                     This version was released:
  26.                           November 1989
  27.  
  28.  
  29.  
  30.  
  31.                  Copyright 1989 by Hagop Janoyan
  32.  
  33.  
  34.  
  35.              This documentation was last revised on:
  36.                         November 23, 1989
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49. WARNING:  I retain all rights to this program and its source code.
  50. This program may be distributed freely for trial purposes ONLY.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                       -- HagScript Manual --                 ( 1 )
  66.  
  67.  
  68.  
  69.  
  70.  
  71. INTRODUCTION
  72.  
  73.  
  74.      In HagTerm Elite, you have access to over 90 commands, called
  75. "HagScript"  commands.   These HagScript commands replace some  of
  76. Hagterm Elite's functions which would otherwise require you to use
  77. the  mouse  to access them.   They also allow you  to  automate  a
  78. series of functions by using HagScript commands.  For example, you
  79. could design your own menus which would allow you or another  user
  80. to press one key and specify a filename; thereafter, the HagScript
  81. would  automatically log-on to a BBS and download that file  at  a
  82. specified time.
  83.  
  84.      The  "AUTO-LOG"  function of the Dialer also  uses  HagScript
  85. commands  to  automatically log-on to a BBS  using  the  specified
  86. "WAIT/ANSWER" strings.
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                       -- HagScript Manual --                 ( 2 )
  132.  
  133.  
  134.  
  135.  
  136.  
  137. CONSTRUCTION
  138.  
  139.  
  140.      Every  HagScript  command consists of one key  word,  plus  a
  141. different  number  of parameters seperated by the  character  "|".
  142. For example, the HagScript command:
  143.  
  144.           PRINT 5|10|Hi There!
  145.  
  146. consists of the keyword "PRINT",  plus three parameters: "5", "10",
  147. and "Hi There!".   (NOTE:  This command would print the string "Hi
  148. There!"  at the x position 5 and y position 10.   Please  see  the
  149. list of HagScript commands for an explanation)
  150.  
  151.  
  152.      Furthermore,  each  parameter  can  consist  of  a  variable.
  153. HagScript has three types of variables;  System Variables,  String
  154. Variable,  and Numerical Variable.   They all can be used not only
  155. in HagScript commands,  but also in Macros,  Auto-Log (through the
  156. Dial mode), etc. (best thing to do is to investigate!).
  157.  
  158.  
  159. 1) System Variables
  160.  
  161.      System variables consist of 80 different possible  variables.
  162.      They  are  _not_  user-definable,   but  rather  are  defined
  163.      automatically  by HagTerm Elite.   They  include  information
  164.      such as the current cursor position, the current default disk
  165.      path,  etc.   They  can  be asscesed  through  the  following
  166.      manner:   You  must enclose the variable name with ~# and  #.
  167.      The  variable  consist  of  word  or  words,  such  as  TIME,
  168.      DIAL.CODE, etc.  There is no case distinction; therefore Time
  169.      and TIME are the same system variables.  Here is an example:
  170.  
  171.           PRINT ~#CURSOR.X#|10|This is a test...
  172.  
  173.      would  consist of the keyword "PRINT" plus three  parameters;
  174.      the first parameter is the System Variable CURSOR.X (which is
  175.      the current X position of the cursor),  the second  parameter
  176.      is  the string "10",  and the third parameter is  the  string
  177.      "This is a test...".
  178.  
  179.  
  180. 2) String Variables
  181.  
  182.      A  String variable is similar to a  System  variable,  except
  183.      that  they are user definable and the variable names  consist
  184.      of  only  letters  from A to Z.   You  can  define  a  String
  185.      variable  by using the "LET" command,  discussed in the  next
  186.      section.   A  String  variable can  contain  any  characters,
  187.      including letters,  digits,  CONTROL characters, punctuation,
  188.      etc.  Basically, it can contain any valid ASCII character.
  189.  
  190.      A  String  variable  can  be  specified  in  a  parameter  by
  191.      enclosing it in the characters "}" and "{".  For example, the
  192.      HagScript commands:
  193.  
  194.           LET }A{|Atari ST
  195.  
  196.  
  197.                       -- HagScript Manual --                 ( 3 )
  198.  
  199.  
  200.  
  201.  
  202.  
  203.           LET }C{|use it carefully
  204.           PRINT 10|20|This is a }A{ system, so please }C{.
  205.  
  206.      would  first  define the String variable "A" to  contain  the
  207.      string  "Atari ST",  and the String variable "C"  to  contain
  208.      "use it carefully.  Then, the third command would display the
  209.      following string:   "This is a Atari ST system, so please use
  210.      it carefully."
  211.  
  212.  
  213. 3) Numerical Variables
  214.  
  215.      A  Numerical  variable  is  similar  to  a  String  variable.
  216.      However, like the name implies, it can only contain numerical
  217.      values.   Like the String variable,  valid Numerical variable
  218.      names include all letters from A to Z.
  219.  
  220.      Unlike a String variable,  a Numerical variable is  specified
  221.      in  a parameter by enclosing it with the characters  "]"  and
  222.      "[".   Attempting  to  define a Numerical variable  a  string
  223.      which  consists  of  letters  will  not  produce  an   error.
  224.      Instead, that Numerical variable will contain the value "0".
  225.  
  226.      For example, the HagScript commands:
  227.  
  228.           LET ]A[|50
  229.           LET ]B[|3*]A[
  230.           LET ]C[|TEST!
  231.           PRINT 10|10|The value for B is: ]B[
  232.           PRINT 10|11|The value for C is: ]C[
  233.  
  234.      would  first define the Numerical variable A to be  equal  to
  235.      50.   Numerical variable B would equal 3*A,  or 3*50, or 150.
  236.      Later,   the  third  command  attempts  to  define  Numerical
  237.      variable  C  to be equal to  the  string  "TEST!".   However,
  238.      Numerical  variable C would become equal to 0  instead.   The
  239.      fourth  command prints the text "The value for  B  is:  150",
  240.      following  by  the fifth command which prints the  text  "The
  241.      value for C is: 0".
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                       -- HagScript Manual --                 ( 4 )
  264.  
  265.  
  266.  
  267.  
  268.  
  269. LIST OF PRE-DEFINED SYSTEM VARIABLES
  270.  
  271.  
  272.      The  following  are System variable names which  are  defined
  273. automatically by Hagterm Elite.   You can use them in your command
  274. parameters, but they cannot be user defined.
  275.  
  276. Serial Port Settings:
  277. ---------------------
  278. LINEFEED      Linefeed status
  279. DUPLEX        Duplex status
  280. CHAR          Char Length
  281. STOPBITS      Stop Bits
  282. FLOW          Flow Control
  283. BAUD          Current Baud Rate
  284.  
  285. Dialing Method Settings:
  286. ------------------------
  287. DIAL.LOG            Dialing Method, use Auto-log when dialing
  288. DIAL.AUTODIAL       Dialing Method, autodial
  289. DIAL.CONFIG         Dialing Method, configure when dialing
  290. DIAL.AUTO.SCRIPT    Dialing Method, Autodial and load Script status
  291. DIAL.AUTO.DEFAULT   Dialing  Method,  Autodial and  load  Defaults status
  292. DIAL.AUTO.REDIAL    Dialing Method, Autodial and Redial status
  293. DIAL.AUTO.MULTI     Dialing  Method,  Autodial and  dial  multiple items
  294.  
  295. OTHER SETTINGS:
  296. ---------------
  297. BUFFER        Capture to Buffer status
  298.  
  299. OTHER:
  300. ------
  301. MODE          The current mode the user is in: 0 - Main Menu
  302.                1 - Terminal Mode    2 - Editor Mode
  303. CURSOR.X      Current X position of cursor
  304. CURSOR.Y      Current Disk Directory/Path
  305. PATH          The current and default Directory/Path
  306. PASS          The Password of the last dialed Item
  307. USER          The Username of the last dialed Item
  308. TIME          Current System Time
  309. DATE          Current Date Time
  310. WAIT          See below for the keyword WAIT          
  311. INPUT         The  string  for  a  user input  -  Please  see  the commands
  312.               INPUT, INKEY, and FILESELECT below
  313. WAIT.TIME     The   time  to  wait  for  specified   through   the
  314.               command WAITTIME
  315. WAIT.DATE     The  date to wait for specified through the  command
  316.               WAITDATE
  317.  
  318.  
  319. GRAPHICS:
  320. ---------
  321. DRAW.0    >    
  322. DRAW.1    >
  323. DRAW.2    >  Please see the command DRAW below
  324. DRAW.4    >
  325. DRAW.5    >
  326.  
  327.  
  328.  
  329.                       -- HagScript Manual --                 ( 5 )
  330.  
  331.  
  332.  
  333.  
  334.  
  335. LIST OF VALID KEYWORDS
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342. 1   KEYWORD:  PRINT
  343.  
  344.  PARAMETERS:  1) X position
  345.               2) Y position
  346.               3) String to be printed
  347.  
  348. EXPLANATION:  Prints a string to the screen at the character
  349.               position of X (column) and Y (row).
  350.  
  351.    EXAMPLES:  PRINT 5|6|Hi there!
  352.  
  353.               (Prints  the string "Hi there!" to the screen  at  X
  354.               position 5 and Y position 6)
  355.  
  356.      
  357.               PRINT ~#CURSOR.X#|~#CURSOR.Y#|This is a string...
  358.  
  359.               (Prints  the  string "This is a  string..."  to  the
  360.               screen at the current cursor position)
  361.  
  362.  
  363. SPECIAL NOTES:   This command moves the current cursor position to
  364.                  the position at the END of the string printed.
  365.  
  366.                  This is similar to GFA Basic's PRINT AT command.
  367.  
  368. ------------------------------------------------------------------
  369.  
  370.     KEYWORD:  WAIT
  371.  
  372.  PARAMETERS:  1) String to wait for
  373.               2) Maximum time to wait for; in 50th of a second.
  374.  
  375. EXPLANATION:  Halts  the HagScript execution until the  specified
  376.               string is found from the serial port.  If it is not
  377.               found within the maximum time specified,  then  the
  378.               command  is aborted.   If the specified time  is  0
  379.               seconds,  then the command will NOT abort until the
  380.               string is found.
  381.  
  382.               If  the  String is not found  within  the  specified
  383.               time, then the system variable WAIT will contain the
  384.               value 0; otherwise, it will contain the value 1.
  385.  
  386.    EXAMPLES:  WAIT Enter user Name|500
  387.               IF ~#WAIT#~|=|1|PRINT 1|1|String is found!     
  388.  
  389.               (Waits until the string "Enter user Name" is  found,
  390.               or until 10 seconds have passed.)
  391.  
  392.               WAIT Password|0
  393.  
  394.  
  395.                       -- HagScript Manual --                 ( 6 )
  396.  
  397.  
  398.  
  399.  
  400.  
  401.               
  402.  
  403.               (Waits until the string "Password" is found)
  404.  
  405. ------------------------------------------------------------------
  406.  
  407.     KEYWORD:  DELAY
  408.  
  409.  PARAMETERS:  1) 100th of a second to pause
  410.  
  411. EXPLANATION:  Delays the execution of further HagScript commands.
  412.               However, all other functions, such as input/output
  413.               from the modem, will perform.  Only further
  414.               HagScript commands will be delayed.
  415.  
  416.    EXAMPLES:  DELAY 650
  417.               PRINT 5|5|Hi There!
  418.  
  419.               (Waits 6.5 seconds, then prints the string "Hi
  420.               There!" to the screen.)
  421.  
  422. SPECIAL NOTES:
  423.  
  424. ------------------------------------------------------------------
  425.  
  426.     KEYWORD:  MODE
  427.  
  428.  PARAMETERS:  1) Mode number
  429.  
  430. EXPLANATION:  Switch to the specified Mode
  431.  
  432.                  Mode 0:  Main Menu
  433.                  Mode 1:  Terminal Mode
  434.                  Mode 2:  Editor Mode
  435.                  Mode 3:  Dial Mode
  436.  
  437.    EXAMPLES:  MODE 1
  438.  
  439.               (Switch to Terminal Mode)
  440.  
  441. SPECIAL NOTES:
  442.  
  443. ------------------------------------------------------------------
  444.  
  445.     KEYWORD:  KEYPRESS
  446.  
  447.  PARAMETERS:  1) String
  448.  
  449. EXPLANATION:  Simulates a keypress of the specified characters in
  450.               the string.
  451.  
  452.    EXAMPLES:  KEYPRESS been
  453.  
  454.               (equivalent  of pressing the "b" key,  and then  the
  455.               "e" key twice, and then the "n" key on the keyboard)
  456.  
  457. SPECIAL NOTES:   Within the string, the characters "&&" will sound
  458.                  a single Bell, and the characters "~~" will pause
  459.  
  460.  
  461.                       -- HagScript Manual --                 ( 7 )
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                  for half a second.
  468.  
  469.                    EXAMPLE: KEYPRESS the bell && now a pause ~~ ok
  470.  
  471.                     (Simulates the keypresses "the bell ", then a
  472.                     bell is sounded, then the keypresses " now a
  473.                     pause " is simulated, followed by half a
  474.                     one second pause, then the keypresses " ok" is
  475.                     simulated.)
  476.  
  477. ------------------------------------------------------------------
  478.  
  479.     KEYWORD:  OUT
  480.  
  481.  PARAMETERS:  1) String
  482.  
  483. EXPLANATION:  Sends out through the modem the specified string.
  484.  
  485.    EXAMPLES:  OUT example
  486.  
  487.               (sends out the string "example" to the modem)
  488.  
  489. SPECIAL NOTES:   Within the string, the characters "&&" will sound
  490.                  a single Bell, and the characters "~~" will pause
  491.                  for half a second.
  492.  
  493.                    EXAMPLE: OUT the bell && now a pause ~~ ok
  494.  
  495.                     (Sends out to the modem the string "the bell
  496.                     ", then a bell is sounded, then the string
  497.                     " now a pause " is sent, followed by half
  498.                     a one second pause, then the string " ok"
  499.                     is sent to the modem.)
  500.  
  501. ------------------------------------------------------------------
  502.  
  503.     KEYWORD:  PAUSE
  504.  
  505.  PARAMETERS:  1) 100th of a second to pause
  506.  
  507. EXPLANATION:  Pauses for the specified time.  During pause, no
  508.               further HagScript commands will be executed till
  509.               after the specified time.  Also, during pause, no
  510.               action will take place, such as input or output from
  511.               modem, switching modes, etc.
  512.  
  513.    EXAMPLES:  PAUSE 400
  514.               PRINT 10|15|Hi!
  515.  
  516.               (Pauses for 4 seconds, after which it will display
  517.               the string "Hi!" on the screen.)
  518.  
  519. SPECIAL NOTES:
  520.  
  521. ------------------------------------------------------------------
  522.  
  523.     KEYWORD:  TERMINAL
  524.  
  525.  
  526.  
  527.                       -- HagScript Manual --                 ( 8 )
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  PARAMETERS:  none
  534.  
  535. EXPLANATION:  Switches to Terminal mode
  536.  
  537.    EXAMPLES:  TERMINAL
  538.           
  539.               (Switch to Terminal Mode)
  540.  
  541. SPECIAL NOTES:
  542.  
  543. ------------------------------------------------------------------
  544.  
  545. 1   KEYWORD:  INPUT
  546.  
  547.  PARAMETERS:  1) Number of characters allowed
  548.               2) Default string
  549.  
  550. EXPLANATION:  Prompts  the  user  for an input  of  a  string  of
  551.               specified length.  The user must press a [RETURN] to
  552.               accept his input.  The default string will initially
  553.               be displayed, which the user can edit.
  554.  
  555.               The accepted input string is then available for use
  556.               by HagScript under the System variable INPUT.
  557.               
  558.    EXAMPLES:  INPUT 30|You can edit this input
  559.               PRINT 10|15|~#INPUT#
  560.  
  561.               (Prompts the user for an input for a string of 30
  562.               characters.  The string "You can edit this input" is
  563.               initially shown and can be editted.  After the user
  564.               accepts the input by pressing [RETURN], the input
  565.               string is displayed on the screen with the PRINT
  566.               command)
  567.  
  568. SPECIAL NOTES:   This is similar to GFA Basic's INPUT AS command.
  569.  
  570. ------------------------------------------------------------------
  571.  
  572.     KEYWORD: STRICT
  573.  
  574.  PARAMETERS:
  575.  
  576. EXPLANATION:
  577.  
  578.    EXAMPLES:
  579.  
  580.  
  581. SPECIAL NOTES:
  582.  
  583. ------------------------------------------------------------------
  584.  
  585.     KEYWORD:  BAUD
  586.  
  587.  PARAMETERS:  1) Baud Rate
  588.  
  589. EXPLANATION:  Changes the current baud rate to the specified baud
  590.               rate, if it is valid.
  591.  
  592.  
  593.                       -- HagScript Manual --                 ( 9 )
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.    EXAMPLES:  BAUD 2400
  601.  
  602.               (changes to 2400 Baud)
  603.  
  604. SPECIAL NOTES:   The following baud rates are valid:  50, 75, 110,
  605.                  134, 150, 200, 300, 600, 1200, 1800, 2000, 2400,
  606.                  3600, 4800, 9600, and 19200.
  607.  
  608. ------------------------------------------------------------------
  609.  
  610.     KEYWORD:  LINEFEED
  611.  
  612.  PARAMETERS:  1) Linefeed value
  613.  
  614. EXPLANATION:  Changes the Linefeeds to either ON or OFF or TOGGLES
  615.               it.  A value of 0 turns Linefeed OFF; a value of
  616.               1 turns the Linefeeds ON; and a value of -1 TOGGLES
  617.               the status of the Linefeeds.
  618.  
  619.    EXAMPLES:  LINEFEED 1
  620.  
  621.               (Turns Linfeeds ON)
  622.  
  623. SPECIAL NOTES:
  624.  
  625. ------------------------------------------------------------------
  626.  
  627.     KEYWORD: DUPLEX
  628.  
  629.  PARAMETERS:  1) Duplex value
  630.  
  631. EXPLANATION:  Either selects Half or Full Duplex, or TOGGLES the
  632.               status of the Duplex.  A value of 0 selects Full
  633.               Duplex; a value of 1 selects Half Duplex; and a value
  634.               of -1 toggles between Half and Full Duplex.
  635.  
  636.    EXAMPLES:  DUPLEX 0
  637.  
  638.               (Selects Full Duplex)
  639.  
  640. SPECIAL NOTES:
  641.  
  642. ------------------------------------------------------------------
  643.  
  644. 1   KEYWORD:  CLS
  645.  
  646.  PARAMETERS:  none
  647.  
  648. EXPLANATION:  Clears the screen (Terminal).
  649.  
  650.    EXAMPLES:  CLS
  651.  
  652. SPECIAL NOTES:   This is similar to GFA Basic's CLS command.
  653.  
  654. ------------------------------------------------------------------
  655.  
  656.     KEYWORD:  DIAL
  657.  
  658.  
  659.                       -- HagScript Manual --                ( 10 )
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  PARAMETERS:  none
  667.  
  668. EXPLANATION:  Switches to Dial Mode
  669.  
  670.    EXAMPLES:  DIAL
  671.  
  672. SPECIAL NOTES:
  673.  
  674. ------------------------------------------------------------------
  675.  
  676.     KEYWORD:  MAIN
  677.  
  678.  PARAMETERS:  none
  679.  
  680. EXPLANATION:  Switches to Main Menu
  681.  
  682.    EXAMPLES:  MAIN
  683.  
  684. SPECIAL NOTES:
  685.  
  686. ------------------------------------------------------------------
  687.  
  688.     KEYWORD:  INKEY
  689.  
  690.  PARAMETERS:  none
  691.  
  692. EXPLANATION:  Waits for a single keypress.  The key pressed is
  693.               stored in the System variable INPUT.
  694.  
  695.    EXAMPLES:  INKEY
  696.               PRINT 1|1|You pressed: ~#INPUT#
  697.  
  698.               (Waits for a keypress, and displays the key pressed
  699.               on the screen.)
  700.  
  701. SPECIAL NOTES:   This is similar to GFA Basic's INP(2) command.
  702.  
  703. ------------------------------------------------------------------
  704.  
  705.     KEYWORD:  FILESELECT
  706.  
  707.  PARAMETERS:  1) Path
  708.               2) Default file
  709.               3) Message to be displayed
  710.  
  711. EXPLANATION:  This command places a file selector box on the
  712.               screen with which the directory of a disk can be
  713.               shown and a file an be selected.
  714.  
  715.               The Path Parameter contains the name of the disk
  716.               drive and folder that is to be shown.  If no disk
  717.               drive is given, the current disk drive will be
  718.               shown.  The Default Parameter is the name of the
  719.               file that is to be shown when the file selector box
  720.               appears.  The Message Parameter is a string of text
  721.               that will appear on top of the screen that the user
  722.               can read.
  723.  
  724.  
  725.                       -- HagScript Manual --                ( 11 )
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.               The chosen file that will be selected after the OK
  733.               button of the file selector box is clicked on is
  734.               stored in the System Variable INPUT.
  735.  
  736.    EXAMPLES:  FILESELECT A:*.*|HAGTERM.TXT|Select The File to View
  737.               TYPE ~#INPUT#
  738.  
  739.               (Displays a file selector box with the directory
  740.               listing of all files on Drive A:.  The file
  741.               HAGTERM.TXT is the default file.  The message
  742.               "Select The File to View" is displayed on top of the
  743.               screen.  The chosen file is then displayed onto the
  744.               screen with the TYPE command.)
  745.  
  746.  
  747. SPECIAL NOTES:  This is similar to GFA Basic's FILESELECT command.
  748.  
  749. ------------------------------------------------------------------
  750.  
  751.     KEYWORD:  MACRO
  752.  
  753.  PARAMETERS:  1) Number of Macro
  754.  
  755. EXPLANATION:  Performs the specified Macro.  Macro #1 specifies
  756.               Macro F1, Macro #2 is Macro F2, etc.
  757.  
  758.    EXAMPLES:  MACRO 12
  759.  
  760.               (Performs the Macro #12, or Macro Shift-F2)
  761.  
  762. SPECIAL NOTES:
  763.  
  764. ------------------------------------------------------------------
  765.  
  766.     KEYWORD:  STATUS
  767.  
  768.  PARAMETERS:  1) Value of terminal status
  769.  
  770. EXPLANATION:  Turns ON or OFF or TOGGLES the display of the status
  771.               line on the terminal screen.  A value of 0 specified
  772.               Status Line OFF; a value of 1 specifies Status
  773.               Line ON; and a value of -1 TOGGLES the Terminal
  774.               status display.
  775.  
  776.    EXAMPLES:  STATUS 1
  777.  
  778.               (Turns on the Terminal Status Line)
  779.  
  780. SPECIAL NOTES:
  781.  
  782. ------------------------------------------------------------------
  783.  
  784.     KEYWORD:  ALERT
  785.  
  786.  PARAMETERS:  1) Alert ICON type
  787.               2) Message to be displayed in the Alert Box
  788.               3) Default Button
  789.  
  790.  
  791.                       -- HagScript Manual --                ( 12 )
  792.  
  793.  
  794.  
  795.  
  796.  
  797.               4) List of the names of the button
  798.  
  799. EXPLANATION:  It will display an Alert Box, which will allow the
  800.               user to make a choice of up to three buttons.
  801.  
  802.   Parameter 1=ICON Type: This defines the symbol that is to appear
  803.                          in the left half of the alert box symbol.
  804.                          The following symbols are available:
  805.  
  806.                               0 = No Symbol
  807.                               1 = Explanation Mark
  808.                               2 = Question Mark
  809.                               3 = Stop Sign
  810.  
  811.   Parameter 2=  Message: This string is the text that will appear
  812.                          in the Alert Box.  Four lines with a
  813.                          maximum of 30 characters are allowed.
  814.                          The lines are seperated with a "\"
  815.                          character.
  816.  
  817.   Parameter 3= Default:  This sets the default mouse button that
  818.                          will be highlighted in the Alert Box.
  819.                          This button can be selected by simply
  820.                          pressing RETURN or ENTER, as well as
  821.                          being selected with the mouse button.
  822.  
  823.   Parameter 4= Buttons:  This string contains the text for the
  824.                          menu buttons.  The maximum text length
  825.                          per button is 8 characters.  The text of
  826.                          the individual buttons are seperated by a
  827.                          "\" character.  A maximum of three
  828.                          buttons are permitted.
  829.  
  830.               When the user makes a choice of a button, the number
  831.               of the button selected can be found in the System
  832.               Variable I.
  833.  
  834.    EXAMPLES:  ALERT 2|Please Select One of the\Following
  835.                  Choice|1|HELP\OK\CANCEL
  836.  
  837.               (Displays an Alert Box with a Question Mark with a
  838.               two line Message: Line 1 says "Please Select One of
  839.               the"; line 2 says "Following Choices".  There are
  840.               three possible buttons: "HELP", "OK", and "CANCEL".
  841.               The first button is the default button and is
  842.               highlighted.)
  843.  
  844.  
  845. SPECIAL NOTES:   This is similar to GFA Basic's ALERT command.
  846.  
  847. ------------------------------------------------------------------
  848.  
  849.     KEYWORD:  MENU
  850.  
  851.  PARAMETERS:  1) Menu command
  852.  
  853. EXPLANATION:  Equivalent to selecting the specified Menu Item from
  854.               the Main Menu.
  855.  
  856.  
  857.                       -- HagScript Manual --                ( 13 )
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.    EXAMPLES:  MENU Save Defaults
  865.  
  866.               (Equivalent to selecting "Save Defaults" menu item
  867.               from the Main Menu, which would allow you to save
  868.               most defaults.)
  869.  
  870. SPECIAL NOTES:
  871.  
  872. ------------------------------------------------------------------
  873.  
  874.     KEYWORD:  DIR
  875.  
  876.  PARAMETERS:  1) Path/Wildcards
  877.  
  878. EXPLANATION:  Displays a directory listing of the specified path.
  879.  
  880.    EXAMPLES:  DIR A:\*.*
  881.  
  882.               (Displays a directory of all files on the root
  883.               directory of Drive A:)
  884.  
  885. SPECIAL NOTES:   Wildcards are allowed.
  886.  
  887. ------------------------------------------------------------------
  888.  
  889.     KEYWORD:  EXECUTE
  890.  
  891.  PARAMETERS:  1) Program filename
  892.               2) Command line to be passed
  893.  
  894. EXPLANATION:  Executes the specified program and passes to it the
  895.               specified command line.
  896.  
  897.    EXAMPLES:  EXECUTE ARC.TTP|v GAME.ARC
  898.  
  899.               (Executes the program "ARC.TTP" and sends to that
  900.               program the command line "v GAME.aRC")
  901.  
  902. SPECIAL NOTES:   This is similar to GFA Basic's EXEC command.
  903.  
  904. ------------------------------------------------------------------
  905.  
  906.     KEYWORD:  LOADDIAL
  907.  
  908.  PARAMETERS:  1) Filename
  909.  
  910. EXPLANATION:  Loads in the specified dial directory from the disk.
  911.  
  912.    EXAMPLES:  LOADDIAL B:\TEST.DIR
  913.  
  914.               (Loads int he dial directory TEST.DIR from the root
  915.               directory of drive B:.)
  916.  
  917. SPECIAL NOTES:
  918.  
  919. ------------------------------------------------------------------
  920.  
  921.  
  922.  
  923.                       -- HagScript Manual --                ( 14 )
  924.  
  925.  
  926.  
  927.  
  928.  
  929.     KEYWORD:  LOADDEF
  930.  
  931.  PARAMETERS:  1) Defaults filename
  932.  
  933. EXPLANATION:  Loads in the specified defaults file from the disk.
  934.  
  935.    EXAMPLES:  LOADDEF A:\NEW.DEF
  936.  
  937.               (Loads in the Defaults file NEW.DEF from the root
  938.               directory of Drive A:.)
  939.  
  940. SPECIAL NOTES:
  941.  
  942. ------------------------------------------------------------------
  943.  
  944.     KEYWORD:  IF
  945.  
  946.  PARAMETERS:  1) First statement
  947.               2) Operation
  948.               3) Second statement
  949.               4) HagScript command to be performed
  950.  
  951. EXPLANATION:
  952.  
  953.               This command makes it possible to make one command
  954.               operation only when a logical condition is
  955.               fulfilled.  The following example should clarify
  956.               this:
  957.  
  958.               IF ]A[|=|1|PRINT 1|1|Numeric Variable A equals 1
  959.  
  960.               In this case, whenever the Numeric Variable A is
  961.               equal to the value 1, then the message "Numeric
  962.               Variable A equals 1" is displayed.
  963.  
  964.               The First and Second statements (Parameter 1 and 3)
  965.               can be any string or value.  The Operation
  966.               (Parameter 2) must be one of the following:
  967.  
  968.                     =     (equals to)
  969.                     <     (is less than)
  970.                     >     (is bigger than)
  971.                     <=    (is less than or equal to)
  972.                     >=    (is bigger than or equal to)
  973.                     <>    (is not equal to)
  974.  
  975.               Whenever the condition between the First and Second
  976.               statements are met, then the HagScript command in
  977.               Parameter 4 is performed.            
  978.  
  979.    EXAMPLES:  LET ]A[|0
  980.               LABEL AGAIN
  981.               LET ]A[|]A[+1
  982.               LET ]Y[|~#CURSOR.Y#+1
  983.               PRINT 1|]Y[|Numeric Variable A is equal to ]A[
  984.               IF ]A[|<=|10|GOTO AGAIN
  985.               CLS
  986.               PRINT 1|1|That's it!
  987.  
  988.  
  989.                       -- HagScript Manual --                ( 15 )
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.               (Displays the numbers 1 through 10 on the screen,
  997.               followed by clearing the screen and displaying the
  998.               text "That's it!".)
  999.                
  1000.  
  1001. SPECIAL NOTES:   This command is comparable to GFA Basic's IF ...
  1002.                  THEN command.
  1003.  
  1004. ------------------------------------------------------------------
  1005.  
  1006.     KEYWORD:  DO
  1007.  
  1008.  PARAMETERS:
  1009.  
  1010. EXPLANATION:  NOT COMPLETED YET!
  1011.  
  1012.    EXAMPLES:
  1013.  
  1014.  
  1015. SPECIAL NOTES:
  1016.  
  1017. ------------------------------------------------------------------
  1018.  
  1019.     KEYWORD:  GOTO
  1020.  
  1021.  PARAMETERS:  1) Label name to GOTO
  1022.  
  1023. EXPLANATION:  Branches further execution to the Label name
  1024.               specified.  The label name corresponds to the name
  1025.               set by the "LABEL" command.
  1026.  
  1027.    EXAMPLES:  LABEL again
  1028.               LET }A{|}Y{+1
  1029.               PRINT 1|}A{|This is a test...
  1030.               GOTO again
  1031.  
  1032.               (prints the text "This is a test..." onto the screen
  1033.               continuosly, one after another.)
  1034.  
  1035.  
  1036. SPECIAL NOTES:   This command searches the whole Script for a
  1037.                  corresponding Label command with the specified
  1038.                  name, and branches to the first found
  1039.                  correcsponding label.
  1040.  
  1041. ------------------------------------------------------------------
  1042.  
  1043.     KEYWORD:  GOTOL
  1044.  
  1045.  PARAMETERS:  1) Line number
  1046.  
  1047. EXPLANATION:  Further HagScript command execution jumps to the
  1048.               specified line number.
  1049.  
  1050.    EXAMPLES:  PRINT 5|5|Hi!
  1051.               GOTOL
  1052.  
  1053.  
  1054.  
  1055.                       -- HagScript Manual --                ( 16 )
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.               (Displays on the screen the string "Hi!"
  1062.               continuously next to each other.)
  1063.  
  1064. SPECIAL NOTES:
  1065.  
  1066. ------------------------------------------------------------------
  1067.  
  1068.     KEYWORD:  LET
  1069.  
  1070.  PARAMETERS:  1) Name of a String of Numeric variable
  1071.               2) Function or String of the specified variable
  1072.  
  1073. EXPLANATION:  If the specified variable is a String, then that
  1074.               variable is assigned the String specified in
  1075.               Parameter 2.
  1076.  
  1077.               However, if the specified variable is Numeric, then
  1078.               HagTerm performs the specified function and assigns
  1079.               a numeric value to the specified variable.  The
  1080.               function is similar to other functions like in a
  1081.               Basic interepter.  The following operations are
  1082.               allowed:
  1083.  
  1084.               INT(x)   (takes the integer portion of x)
  1085.               ABS(x)   (returns the absolute value of x)
  1086.               FIX(x)   (returns a whole number)
  1087.               SGN(x)   (returns the sign of x:
  1088.                             if x is negative, SGN(x)=-1
  1089.                             if x is positive, SGN(x)=1
  1090.                             if x equals 0, SGN(x)=0)
  1091.               RND(x)   (generates a random number from 0 and 1)
  1092.               SQR(x)   (returns the square root of x)
  1093.               EXP(x)   (calculates the xth power to the base of
  1094.                        the number)     
  1095.               LGN(x)   (calculaes the natural log of x)
  1096.               FRC(x)   (returns the fractional value of x,
  1097.                        removing the whole number value)
  1098.               LOG(x)   (returns the log of x in base 10)
  1099.               SIN(x), COS(x), TAN(x), ATN(x), RAD(x), DEG(x) (are
  1100.                        self explanatory)
  1101.               FAC(x)   (self-defined factorial)
  1102.  
  1103.    EXAMPLES:  LET ]A[|3*10
  1104.               LET ]B[|SGN(100)*10
  1105.               LET ]C[|INT(1.7)
  1106.               LET ]D[|FRC(3.4)
  1107.               LET ]E[|(SQR(9)*INT(2.3)*]A[)+]C[
  1108.               PRINT 1|1|]A[
  1109.               PRINT 1|2|]C[
  1110.               PRINT 1|3|]D[
  1111.               PRINT 1|4|]E[
  1112.  
  1113.               (prints to the screen the values 30, 10, 1, 0.4, and
  1114.               181)
  1115.  
  1116. SPECIAL NOTES:   This has been developed using the routines found
  1117.                  in the book "Programming with GFA Basic 3.0"
  1118.  
  1119.  
  1120.  
  1121.                       -- HagScript Manual --                ( 17 )
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127. ------------------------------------------------------------------
  1128.  
  1129. 1   KEYWORD:  SGET
  1130.  
  1131.  PARAMETERS:  1) String Variable Name
  1132.  
  1133. EXPLANATION:  Copies the entire screen into a String variable.
  1134.  
  1135.    EXAMPLES:  SGET }A{
  1136.  
  1137.               (Copies the contents of the screen into the string
  1138.               variable A)
  1139.  
  1140.  
  1141. SPECIAL NOTES:   The variable with the contents of the string will
  1142.                  eat up 32K of memory.
  1143.  
  1144.                  This is similar to GFA Basic's SGET command.
  1145.  
  1146. ------------------------------------------------------------------
  1147.  
  1148. 1   KEYWORD:  SPUT
  1149.  
  1150.  PARAMETERS:  1) String variable with the screen contents
  1151.  
  1152. EXPLANATION:  Copies a string variable with the screen contents
  1153.               (that was specified in the SGET command) into the
  1154.               current screen.
  1155.  
  1156.    EXAMPLES:  SPUT }A{
  1157.  
  1158.               (Puts the contents of the string variable A onto the
  1159.               screen.)
  1160.  
  1161.  
  1162. SPECIAL NOTES:   THE SYSTEM WILL CRASH IF THE STRING VARIABLE DOES
  1163.                  NOT CONTAIN VALID SCREEN CONTENTS!
  1164.  
  1165.                  This is similar to GFA Basic's SPUT command.
  1166.  
  1167. ------------------------------------------------------------------
  1168.  
  1169. 1   KEYWORD:  DRAW
  1170.  
  1171.  PARAMETERS:  1) A String Variable
  1172.  
  1173. EXPLANATION:  With DRAW an imaginary marker will be moved over the
  1174.               screen and is able to draw.  This closely resembles
  1175.               the programming language LOGO.  The individual
  1176.               commands are given in strings.  The commands are:
  1177.  
  1178.           FD n   FORWARD    moves the Pen n Pixels forwards
  1179.           BK n   BACKWARD   moves the Pen n Pixels backwards
  1180.           SX x   SCALE X    scales the Pen movement for FD and BK
  1181.               
  1182.           SY y   SCALE Y    with the given scaling factor
  1183.  
  1184.                  SX and SY  works on n only with the commands FD
  1185.  
  1186.  
  1187.                       -- HagScript Manual --                ( 18 )
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.                             and BK.  The scaling is turned off with
  1194.                             SX0 and SY0
  1195.  
  1196.           LT w   LEFT TURN  gives the angle w around which the
  1197.                             drawing direction is to turn to the
  1198.                             left
  1199.  
  1200.           RT w   RIGHT TURN opposite to the right
  1201.  
  1202.           TT w   TURN TO    returns the current angle w for this
  1203.                             the following assignments:
  1204.  
  1205.  
  1206.                             0
  1207.                             |
  1208.                 270     Zero Point   90
  1209.                             |
  1210.                            180                         
  1211.  
  1212.                (the input for w=angle is in degrees)          
  1213.  
  1214.           MA x,y    MOVE ABSOLUTE  moves the Pen to the absolute
  1215.                                    Coordinates x and y
  1216.  
  1217.           DA x,y    DRAW ABSOLUTE  moves the Pen to the absolute
  1218.                                    Coordinates x and y and draws a
  1219.                                    line in the current color from
  1220.                                    the last Position to the point
  1221.                                    (x,y)
  1222.  
  1223.           MR xr,yr  MOVE RELATIVE  like MA, however moves to the
  1224.                                    last position
  1225.  
  1226.           DR xr,yr  DRAW RELATIVE  like DR, however moves to the
  1227.                                    last position
  1228.  
  1229.      (See the "List of System Variables" for more info)
  1230.  
  1231.    EXAMPLES:  DRAW mx 320,200 tt 0
  1232.               DRAW fd 45 rt 90 fd 45 rt 90 fd 45 rt 90 fd 45
  1233.               DRAW bk 90 rt 90 bk 90 rt 90 bk 90 rt 90 bk 90
  1234.           
  1235.               (Draws a small rectangle)
  1236.  
  1237. SPECIAL NOTES:   The above text was copied from the "GFA Basic 3.0"
  1238.                  manual from MichTron, since the command used the
  1239.                  exact same format.  I'm sorry that I had to do
  1240.                  this, MichTron (or ANTIC!)...
  1241.  
  1242.                  This is similar to GFA Basic's DRAW command.
  1243.  
  1244. ------------------------------------------------------------------
  1245.  
  1246. 1   KEYWORD:  PLOT
  1247.  
  1248.  PARAMETERS:  1) X position
  1249.               2) Y position
  1250.  
  1251.  
  1252.  
  1253.                       -- HagScript Manual --                ( 19 )
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259. EXPLANATION:  Draws a point with the coordinates x and y on the
  1260.               screen.
  1261.  
  1262.    EXAMPLES:  PLOT 50|50
  1263.  
  1264.               (Draws a point at coordinates 50,50)
  1265.  
  1266. SPECIAL NOTES:   This is similar to GFA Basic's PLOT command.
  1267.  
  1268. ------------------------------------------------------------------
  1269.  
  1270. 1   KEYWORD:  LINE
  1271.  
  1272.  PARAMETERS:  1) First X position
  1273.               2) First Y position
  1274.               3) Second X position
  1275.               4) Second Y position
  1276.  
  1277. EXPLANATION:  Draws a line between the first x,y coordinates and
  1278.               the second x,y coordinates.
  1279.  
  1280.    EXAMPLES:  LINE 50|100|500|150
  1281.  
  1282.               (Draws a diagonal line from coordinates 50,100 to
  1283.               coordinates 500,150)
  1284.  
  1285.  
  1286. SPECIAL NOTES:   This is similar to GFA Basic's LINE command.
  1287.  
  1288. ------------------------------------------------------------------
  1289.  
  1290. 1   KEYWORD:  BOX
  1291.  
  1292.  PARAMETERS:  1) Upper-Left X position
  1293.               2) Upper-left Y position
  1294.               3) Lower-right X position
  1295.               4) Lower-right Y position
  1296.  
  1297. EXPLANATION:  Draws a rectangle at the specified positions.
  1298.  
  1299.    EXAMPLES:  BOX 10|10|20|20
  1300.  
  1301.               (Draws a square)
  1302.  
  1303. SPECIAL NOTES:   This is similar to GFA Basic's BOX command.
  1304.  
  1305. ------------------------------------------------------------------
  1306.  
  1307. 1   KEYWORD:  CIRCLE
  1308.  
  1309.  PARAMETERS:  1) Center X coordinate
  1310.               2) Center Y coordinate
  1311.               3) Radius of circle
  1312.  
  1313. EXPLANATION:  Draws a circle at the specified location with the
  1314.               specified radius.
  1315.  
  1316.    EXAMPLES:  CIRCLE 50|50|25
  1317.  
  1318.  
  1319.                       -- HagScript Manual --                ( 20 )
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326. SPECIAL NOTES:   This is similar to GFA Basic's CIRCLE command.
  1327.  
  1328. ------------------------------------------------------------------
  1329.  
  1330. 1   KEYWORD:  COLOR
  1331.  
  1332.  PARAMETERS:  1) Color number (0-3 in lo-res, 0-1 in hi-res)
  1333.  
  1334. EXPLANATION:  Chooses the specified color number to be used in
  1335.               graphics commands like PLOT, BOX, LINE, etc.
  1336.  
  1337.    EXAMPLES:  COLOR 3
  1338.  
  1339.               (chooses Color #3)
  1340.  
  1341. SPECIAL NOTES:   This is similar to GFA Basic's COLOR command.
  1342.  
  1343. ------------------------------------------------------------------
  1344.  
  1345. 1   KEYWORD:  SETCOLOR
  1346.  
  1347.  PARAMETERS:  1) Color number
  1348.               2) Red value of color
  1349.               3) Green value of color
  1350.               4) Blue value of color
  1351.  
  1352. EXPLANATION:  Changes each color (only works in med-res) to the
  1353.               specifed Red, Green, & Blue values.
  1354.  
  1355.    EXAMPLES:  SETCOLOR 2,7,7,7
  1356.  
  1357.               (changes color #2 to pure white)
  1358.  
  1359.               SETCOLOR 3,7,0,0
  1360.  
  1361.               (changes color #3 to red)
  1362.  
  1363. SPECIAL NOTES:   This is similar to GFA Basic's SETCOLOR command.
  1364.  
  1365. ------------------------------------------------------------------
  1366.  
  1367.     KEYWORD:  DEFTEXT
  1368.  
  1369.  PARAMETERS:  1) Color
  1370.               2) Attribute
  1371.               3) Angle
  1372.               4) Height
  1373.  
  1374. EXPLANATION:  Sets the appearance of a character string that is
  1375.               displayed with the TEXT command.
  1376.  
  1377.               The Color Parameter contains the color of the text,
  1378.               ranging from 0 to 15.  The Attribute Parameter
  1379.               contains the attributes of the text.  These coan be
  1380.               conbined by combining the following identification
  1381.               numbers:
  1382.  
  1383.  
  1384.  
  1385.                       -- HagScript Manual --                ( 21 )
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.                  0 - Normal
  1392.                  1 - Bold
  1393.                  2 - Light
  1394.                  4 - Italic
  1395.                  8 - Underlined
  1396.                 16 - Outlined
  1397.  
  1398.               The Angle Parameter sets the direction of the text
  1399.               output.  The following values are allowed:
  1400.  
  1401.                  0    -  Preset, from left to right
  1402.                  900  -  From bottom to top
  1403.                  1800 -  Upside down, from right to left
  1404.                  2700 -  Backwards from top to bottom              
  1405.  
  1406.               The Height Parameter gives the height of an upper
  1407.               case letter in pixels.  Only the following script
  1408.               heights are readable with normal character sets:
  1409.  
  1410.                  4  -  Icon script height
  1411.                  6  -  Small script height
  1412.                  13 -  Normal script height
  1413.                  32 -  Especially large script height
  1414.  
  1415.    EXAMPLES:  DEFTEXT 1|9|0|32
  1416.               TEXT 50|15|Hagop is the BEST!
  1417.  
  1418.               (Displays a string of text in color 1 (usually
  1419.               black), in a bold underlined text, and in a
  1420.               especially large script height.)
  1421.  
  1422. SPECIAL NOTES:   This is similar to GFA Basic's DEFTEXT command.
  1423.  
  1424. ------------------------------------------------------------------
  1425.  
  1426. 1   KEYWORD:  TEXT
  1427.  
  1428.  PARAMETERS:  1) X pixel position
  1429.               2) Y pixel position
  1430.               3) Text to be displayed
  1431.  
  1432. EXPLANATION:  Displays the specified text string as a graphic text
  1433.               at the specified X and Y coordinates.  This point is
  1434.               located at the left corner of the first character of
  1435.               the text string.
  1436.  
  1437.               The graphic text can be given attributes with the
  1438.               DEFTEXT command.
  1439.  
  1440.    EXAMPLES:  TEXT 100|150|This is text
  1441.  
  1442.               (Displays the string "This is text" with the font
  1443.               specified by DEFTEXT at the 100 X pixel and 150 Y
  1444.               pixel.)
  1445.  
  1446. SPECIAL NOTES:   This is similar to GFA Basic's TEXT command.
  1447.  
  1448. ------------------------------------------------------------------
  1449.  
  1450.  
  1451.                       -- HagScript Manual --                ( 22 )
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.     KEYWORD:  ACCESS
  1459.  
  1460.  PARAMETERS:  1) Access status value
  1461.  
  1462. EXPLANATION:  When the Access status value is 1, then no
  1463.               input/output will occur between the user and the
  1464.               system.  Only the HagScript commands will function.
  1465.               For instance, the user cannot change between Modes
  1466.               when Access is equal to 1.  When the value is 0,
  1467.               then everything will operate.  When the value is -1,
  1468.               then the Access will TOGGLE between a value of 0 and
  1469.               a value of 1.
  1470.  
  1471.    EXAMPLES:  ACCESS 1
  1472.  
  1473.               (Turns Access to a value of 1)
  1474.  
  1475. SPECIAL NOTES:   The STOP command automatically sets Access to 0.
  1476.  
  1477. ------------------------------------------------------------------
  1478.  
  1479.     KEYWORD:  STOP
  1480.  
  1481.  PARAMETERS:  none
  1482.  
  1483. EXPLANATION:  Stops further execution of other HagScript commands.
  1484.  
  1485.    EXAMPLES:  STOP
  1486.  
  1487. SPECIAL NOTES:   This command will also abort any WAIT or DELAY
  1488.                  commands.
  1489.  
  1490. ------------------------------------------------------------------
  1491.  
  1492.     KEYWORD:  DELETE
  1493.  
  1494.  PARAMETERS:  1) File to be deleted
  1495.  
  1496. EXPLANATION:  Deletes the specified files.  Wildcards are allowed.
  1497.  
  1498.    EXAMPLES:  DELETE A:\*.*
  1499.  
  1500.               (Deletes all files on the root directory of Drive
  1501.               A:.)
  1502.  
  1503. SPECIAL NOTES:   The deleted files are deleted permanently.
  1504.  
  1505.                  This is similar to GFA Basic's KILL command.
  1506.                  
  1507. ------------------------------------------------------------------
  1508.  
  1509.     KEYWORD:  MFOLDER
  1510.  
  1511.  PARAMETERS:  1) Folder name
  1512.  
  1513. EXPLANATION:  Creates the specified folder.
  1514.  
  1515.  
  1516.  
  1517.                       -- HagScript Manual --                ( 23 )
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.    EXAMPLES:  MFOLDER AUTO
  1524.  
  1525.               (Creates a folder named AUTO)
  1526.  
  1527. SPECIAL NOTES:   This is similar to GFA Basic's MKDIR command.
  1528.                  
  1529. ------------------------------------------------------------------
  1530.  
  1531.     KEYWORD:  DFOLDER
  1532.  
  1533.  PARAMETERS:  1) Folder to be deleted
  1534.  
  1535. EXPLANATION:  Deletes the specified folder
  1536.  
  1537.    EXAMPLES:  DFOLDER AUTO
  1538.  
  1539.               (Deletes the folder named AUTO and all files inside
  1540.               that folder)
  1541.  
  1542. SPECIAL NOTES:   This is similar to GFA Basic's RMDIR command.
  1543.                  
  1544. ------------------------------------------------------------------
  1545.  
  1546.     KEYWORD:  TYPE
  1547.  
  1548.  PARAMETERS:  1) Filename to be displayed
  1549.  
  1550. EXPLANATION:  Displays the specified file to the screen.
  1551.  
  1552.    EXAMPLES:  TYPE A:\HAGTERM.TXT
  1553.  
  1554.               (Displays the filename A:\HAGTERM.TXT)
  1555.  
  1556. SPECIAL NOTES:   
  1557.                  
  1558. ------------------------------------------------------------------
  1559.  
  1560.     KEYWORD:  COPY
  1561.  
  1562.  PARAMETERS:  1) Source filename
  1563.               2) Destination filename
  1564.  
  1565. EXPLANATION:  Copies the specified Source file to the specified
  1566.               Destination file.
  1567.  
  1568.    EXAMPLES:  COPY A:\HAGTERM.PRG|C:\TERM\HAGTERM.PRG
  1569.  
  1570.               (Copies the file HAGTERM.PRG from Drive A: to Drive
  1571.               C: into the folder "TERM")
  1572.  
  1573. SPECIAL NOTES:   
  1574.                  
  1575. ------------------------------------------------------------------
  1576.  
  1577.     KEYWORD:  EDITOR
  1578.  
  1579.  PARAMETERS:  none
  1580.  
  1581.  
  1582.  
  1583.                       -- HagScript Manual --                ( 24 )
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589. EXPLANATION:  Switches to Editor mode
  1590.  
  1591.    EXAMPLES:  EDITOR
  1592.  
  1593. SPECIAL NOTES:   
  1594.                  
  1595. ------------------------------------------------------------------
  1596.  
  1597.     KEYWORD:  CAPTURE
  1598.  
  1599.  PARAMETERS:  1) Capture status value
  1600.  
  1601. EXPLANATION:  Turns ON or OFF or TOGGLES the Capture (as ASCII)
  1602.               status.  A value of 0 will turn Capture OFF; a value
  1603.               of 1 will turn Capture ON; a value of -1 will TOGGLE
  1604.               the Capture status.
  1605.  
  1606.    EXAMPLES:  CAPTURE 0
  1607.  
  1608.               (Turns Capture OFF)
  1609.  
  1610. SPECIAL NOTES:   When Capture is ON, it is equivalent to "Download
  1611.                  ASCII".  However, you must first specify a
  1612.                  filename with the OPENCAP command.
  1613.                  
  1614. ------------------------------------------------------------------
  1615.  
  1616.     KEYWORD:  OPENCAP
  1617.  
  1618.  PARAMETERS:  1) Capture filename
  1619.  
  1620. EXPLANATION:  Opens up a capture file with the specified filename.
  1621.               You must use the CAPTURE command to start capturing
  1622.               text, however.
  1623.  
  1624.    EXAMPLES:  OPENCAP BBS.CAP
  1625.               CAPTURE 1
  1626.                 .
  1627.                 .
  1628.                 .
  1629.               CLOSECAP
  1630.  
  1631.               (opens a capture file named BBS.CAP; then it turns
  1632.               the capturing ON, and afterwards, closes the capture
  1633.               file)
  1634.  
  1635. SPECIAL NOTES:   
  1636.                  
  1637. ------------------------------------------------------------------
  1638.  
  1639.     KEYWORD:  CLOSECAP
  1640.  
  1641.  PARAMETERS:  none
  1642.  
  1643. EXPLANATION:  Closes the capture file
  1644.  
  1645.    EXAMPLES:  See above
  1646.  
  1647.  
  1648.  
  1649.                       -- HagScript Manual --                ( 25 )
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655. SPECIAL NOTES:   
  1656.                  
  1657. ------------------------------------------------------------------
  1658.  
  1659.     KEYWORD:  RENAME
  1660.  
  1661.  PARAMETERS:  1) Source Filename
  1662.               2) New Filename
  1663.  
  1664. EXPLANATION:  Will Rename the Source File with a new Filename.
  1665.  
  1666.    EXAMPLES:  RENAME A:\HAGTERM.TXT|A:\HAGTERM.DOC
  1667.  
  1668.               (Will rename the file HAGTERM.TXT into HAGTERM.DOC)
  1669.  
  1670. SPECIAL NOTES:   This command can also be used to MOVE files from
  1671.                  one directory/folder into another
  1672.                  directory/folder.
  1673.  
  1674.                  This is similar to GFA Basic's RENAME AS command.
  1675.                  
  1676. ------------------------------------------------------------------
  1677.  
  1678.     KEYWORD:  DIALNUM
  1679.  
  1680.  PARAMETERS:  1) Number of the Dial Item.
  1681.  
  1682. EXPLANATION:  Will dial the corresponding Dial Item.
  1683.  
  1684.    EXAMPLES:  DIALNUM 2
  1685.  
  1686. SPECIAL NOTES:   
  1687.                  
  1688. ------------------------------------------------------------------
  1689.  
  1690.     KEYWORD:  DIALNAME
  1691.  
  1692.  PARAMETERS:  1) The name (or part of the name) of a Dial Item
  1693.  
  1694. EXPLANATION:   Will  search the Dial Directory till the  specified
  1695.               string matches one of the Dial Items.
  1696.  
  1697.    EXAMPLES:  DIALNAME grave
  1698.  
  1699.               (will dial any Dial Item that has the string "grave"
  1700.               in it, such as "Dead Graveyard")
  1701.  
  1702. SPECIAL NOTES:   
  1703.                  
  1704. ------------------------------------------------------------------
  1705.  
  1706.     KEYWORD:  DIAL.CONFIG
  1707.  
  1708.  PARAMETERS:
  1709.  
  1710. EXPLANATION:
  1711.  
  1712.    EXAMPLES:
  1713.  
  1714.  
  1715.                       -- HagScript Manual --                ( 26 )
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722. SPECIAL NOTES:   
  1723.                  
  1724. ------------------------------------------------------------------
  1725.  
  1726.     KEYWORD:  DIAL.LOG
  1727.  
  1728.  PARAMETERS:
  1729.  
  1730. EXPLANATION:
  1731.  
  1732.    EXAMPLES:
  1733.  
  1734. SPECIAL NOTES:   
  1735.                  
  1736. ------------------------------------------------------------------
  1737.  
  1738.     KEYWORD:  DIAL.AUTODIAL
  1739.  
  1740.  PARAMETERS:
  1741.  
  1742. EXPLANATION:
  1743.  
  1744.    EXAMPLES:
  1745.  
  1746. SPECIAL NOTES:   
  1747.                  
  1748. ------------------------------------------------------------------
  1749.  
  1750.     KEYWORD:  DIAL.AUTO.REDIAL
  1751.  
  1752.  PARAMETERS:
  1753.  
  1754. EXPLANATION:
  1755.  
  1756.    EXAMPLES:
  1757.  
  1758. SPECIAL NOTES:   
  1759.                  
  1760. ------------------------------------------------------------------
  1761.  
  1762.     KEYWORD:  DIAL.AUTO.SCRIPT
  1763.  
  1764.  PARAMETERS:
  1765.  
  1766. EXPLANATION:
  1767.  
  1768.    EXAMPLES:
  1769.  
  1770. SPECIAL NOTES:   
  1771.                  
  1772. ------------------------------------------------------------------
  1773.  
  1774.     KEYWORD:  DIAL.AUTO.DEFAULT
  1775.  
  1776.  PARAMETERS:  1) Value of Dialing Method, AutoDialer autoload
  1777.                Defaults.
  1778.  
  1779.  
  1780.  
  1781.                       -- HagScript Manual --                ( 27 )
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787. EXPLANATION:  A value of 0 specifies the autodialer to not load
  1788.               the specified Defaults file upon connection when
  1789.               Autodialing.  A value of 1 is the opposite.
  1790.  
  1791.    EXAMPLES:
  1792.  
  1793. SPECIAL NOTES:   
  1794.                  
  1795. ------------------------------------------------------------------
  1796.  
  1797.     KEYWORD:  PARITY
  1798.  
  1799.  PARAMETERS:  1) Parity value
  1800.  
  1801. EXPLANATION:  Changes the Parity value.  A value of 0 specifies No
  1802.               Parity; 1 specifies Even Parity, and 2 specifies Odd
  1803.               Parity.
  1804.  
  1805.    EXAMPLES:  PARITY 1
  1806.  
  1807.               (chooses Even Parity)
  1808.  
  1809. SPECIAL NOTES:   
  1810.                  
  1811. ------------------------------------------------------------------
  1812.  
  1813.     KEYWORD:  FLOW
  1814.  
  1815.  PARAMETERS:  1) Value of Flow Control
  1816.  
  1817. EXPLANATION:  Changes Flow Control method.  A value of 0 is "No
  1818.               Flow Control", a value of 1 is "Xon/Xoff", and a
  1819.               value of 2 is "RTS/CTS".
  1820.  
  1821.    EXAMPLES:  FLOW 2
  1822.  
  1823.               (Chooses Flow Control RTS/CTS)
  1824.  
  1825. SPECIAL NOTES:
  1826.                  
  1827. ------------------------------------------------------------------
  1828.  
  1829.     KEYWORD:  STOPBITS
  1830.  
  1831.  PARAMETERS:  1) Stop Bits value  (1, 1.5, or 2)
  1832.  
  1833. EXPLANATION:  Changes the value of the Stop Bits.
  1834.  
  1835.    EXAMPLES:  STOPBITS 2
  1836.  
  1837.               (chooses 2 stop bits)
  1838.  
  1839. SPECIAL NOTES:   
  1840.                  
  1841. ------------------------------------------------------------------
  1842.  
  1843.     KEYWORD:  CHAR
  1844.  
  1845.  
  1846.  
  1847.                       -- HagScript Manual --                ( 28 )
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  PARAMETERS:
  1854.  
  1855. EXPLANATION:
  1856.  
  1857.    EXAMPLES:
  1858.  
  1859. SPECIAL NOTES:   
  1860.                  
  1861. ------------------------------------------------------------------
  1862.  
  1863.     KEYWORD:  BUFFER
  1864.  
  1865.  PARAMETERS:  1) Capture to Buffer status value
  1866.  
  1867. EXPLANATION:  Either turns ON or OFF the capture to Buffer status,
  1868.               which will store the incoming data from the serial
  1869.               port and can then be edited through the Editor.  A
  1870.               value of 0 will turn Buffer OFF; a value of 1 will
  1871.               turn Buffer ON; a value of -1 will TOGGLE the
  1872.               Buffer.
  1873.  
  1874.    EXAMPLES:  BUFFER 0
  1875.  
  1876.               (Turns OFF the Capture to Buffer)
  1877.  
  1878. SPECIAL NOTES:   
  1879.                  
  1880. ------------------------------------------------------------------
  1881.  
  1882.     KEYWORD:  AUTOPAUSE
  1883.  
  1884.  PARAMETERS:  1) Autopause status value
  1885.  
  1886. EXPLANATION:  Turns ON or OFF or TOGGLES the Autopause option.  If
  1887.               the specified value is 0, then Autopause is OFF; a
  1888.               value of 1 will turn Autopause ON; and a value of -1
  1889.               will TOGGLE the status of Autopause.
  1890.  
  1891.    EXAMPLES:  AUTOPAUSE 1
  1892.  
  1893.               (Turns Autopause ON)
  1894.  
  1895. SPECIAL NOTES:   
  1896.                  
  1897. ------------------------------------------------------------------
  1898.  
  1899.     KEYWORD:  PRINTER
  1900.  
  1901.  PARAMETERS:  1) Printer status value
  1902.  
  1903. EXPLANATION:  Either turns ON or OFF or TOGGLES the Printer
  1904.               output.  A value of 0 will turn OFF the Printer
  1905.               output; a value of 1 will turn ON the Printer
  1906.               output; a value of -1 will TOGGLE the Printer
  1907.               output.
  1908.  
  1909.    EXAMPLES:  PRINT -1
  1910.  
  1911.  
  1912.  
  1913.                       -- HagScript Manual --                ( 29 )
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.               (TOGGLES the Printer Output)
  1920.  
  1921. SPECIAL NOTES:   
  1922.                  
  1923. ------------------------------------------------------------------
  1924.  
  1925.     KEYWORD:  KEYCLICK
  1926.  
  1927.  PARAMETERS:  1) Keyclick status value
  1928.  
  1929. EXPLANATION:  Turns ON or OFF or TOGGLES the keyclick sound.  If
  1930.               the specified value is 1, then Keyclick will be OFF;
  1931.               a value of 0 will turn Keyclick ON; and a value of
  1932.               -1 will TOGGLE the status of the Keyclick sound.
  1933.  
  1934.  
  1935.    EXAMPLES:  KEYCLOCK 0
  1936.  
  1937.               (Turns on the Keyclick)
  1938.  
  1939. SPECIAL NOTES:   
  1940.                  
  1941. ------------------------------------------------------------------
  1942.  
  1943.     KEYWORD:  VT52
  1944.  
  1945.  PARAMETERS:  1) VT52 status value
  1946.  
  1947. EXPLANATION:  Turns ON or OFF or TOGGLES the VT52 option.  If the
  1948.               specified value is 1, then VT52 is OFF; a value of 0
  1949.               will turn VT52 ON; and a value of -1 will TOGGLE
  1950.               VT52.
  1951.  
  1952.    EXAMPLES:  VT52 1
  1953.  
  1954.               (Turns off VT52)
  1955.  
  1956. SPECIAL NOTES:   
  1957.                  
  1958. ------------------------------------------------------------------
  1959.  
  1960.     KEYWORD:  REDIAL
  1961.  
  1962.  PARAMETERS:  1) Number of Redials
  1963.  
  1964. EXPLANATION:  Specifies the number of times that the Autodialer
  1965.               should redial a specific number before returning the
  1966.               control to the user.
  1967.  
  1968.    EXAMPLES:  REDIAL 5
  1969.  
  1970.               (Specifies five redials.)
  1971.  
  1972. SPECIAL NOTES:   This can also be set through the Setup Dialog Box
  1973.                  in the Dial Mode.
  1974.                  
  1975. ------------------------------------------------------------------
  1976.  
  1977.  
  1978.  
  1979.                       -- HagScript Manual --                ( 30 )
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.     KEYWORD:  REDIAL.TIME
  1986.  
  1987.  PARAMETERS:  1) Number of seconds to wait before redial
  1988.  
  1989. EXPLANATION:  Specifies the number of seconds to wait when
  1990.               Autodialing before issuing a Redial.
  1991.  
  1992.    EXAMPLES:  REDIAL.TIME 30
  1993.      
  1994.               (Specifies a Redial Time of 30 seconds.)
  1995.  
  1996. SPECIAL NOTES:   This can also be set through the Setup dialog box
  1997.                  in Dial Mode.
  1998.                  
  1999. ------------------------------------------------------------------
  2000.  
  2001.     KEYWORD:  MONO.LINES
  2002.  
  2003.  PARAMETERS:  1) Status of the Extended terminal screen lines
  2004.  
  2005. EXPLANATION:  Either turns ON or OFF or TOGGLES the 48 lines in
  2006.               the terminal screen.  A value of 0 specified 24 lines
  2007.               in the terminal screen (normal); a value of 1
  2008.               specifies 48 lines in the terminal screen (extended);
  2009.               and a value of -1 toggles between 24 and 48 lines.
  2010.  
  2011.    EXAMPLES:  MONO.LINES 1
  2012.  
  2013.               (Selects 48 lines in Terminal screen (extended).)
  2014.  
  2015. SPECIAL NOTES:   48 lines per screen is only available in
  2016.                  high resoloution.
  2017.                  
  2018. ------------------------------------------------------------------
  2019.  
  2020.     KEYWORD:  BELL
  2021.  
  2022.  PARAMETERS:  1) Bell status value
  2023.  
  2024. EXPLANATION:  Turns ON or OFF or TOGGLES the Bell status.  A value
  2025.               of 1 turns the Bell OFF; a value of 0 turns the Bell
  2026.               ON; a value of -1 toggles the status of the Bell.
  2027.  
  2028.    EXAMPLES:  BELL 1
  2029.  
  2030.               (Turns the Bell OFF)
  2031.  
  2032. SPECIAL NOTES:   The Bell is the bell sound that is made by either
  2033.                  the Dialer (during connection) or through the
  2034.                  terminal screen (by pressing the CONTROL+G keys)
  2035.                  or by clicking the mouse button outside a dialog
  2036.                  box.
  2037.  
  2038. ------------------------------------------------------------------
  2039.  
  2040.     KEYWORD:  PRINTFILE
  2041.  
  2042.  PARAMETERS:  1) File to print
  2043.  
  2044.  
  2045.                       -- HagScript Manual --                ( 31 )
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052. EXPLANATION:  Prints the specified file to the printer.
  2053.  
  2054.    EXAMPLES:  PRINTFILE A:\HAGTERM.TXT
  2055.  
  2056.               (Prints to the printer the file HAGTERM.TXT in the
  2057.               root directory of drive A:.)
  2058.  
  2059. SPECIAL NOTES:   
  2060.                  
  2061. ------------------------------------------------------------------
  2062.  
  2063.     KEYWORD:  COLORTOG
  2064.  
  2065.  PARAMETERS:  none
  2066.  
  2067. EXPLANATION:  Inverses the foreground and the background colors.
  2068.  
  2069.    EXAMPLES:  COLORTOG
  2070.  
  2071. SPECIAL NOTES:   
  2072.                  
  2073. ------------------------------------------------------------------
  2074.  
  2075.     KEYWORD:  WAITTIME
  2076.  
  2077.  PARAMETERS:  1) Time string with the format HH:MM:SS
  2078.  
  2079. EXPLANATION:  Halts execution of further HagScript commands until
  2080.               the System Time is equal or more than the specified
  2081.               time.  However, only the HagScript commands will be
  2082.               halted, all other functions will function properly.
  2083.  
  2084.    EXAMPLES:  WAITTIME 10:00:00
  2085.               PRINT 1|1|Hi!
  2086.  
  2087.               (Waits till the time is 10 o'clock, after which it
  2088.               will display the string "Hi!")
  2089.  
  2090. SPECIAL NOTES:   
  2091.                  
  2092. ------------------------------------------------------------------
  2093.  
  2094.     KEYWORD:  WAITDATE
  2095.  
  2096.  PARAMETERS:  1) Date string with the format MM/DD/YY
  2097.  
  2098. EXPLANATION:  Halts execution of further HagScript commands until
  2099.               the System Date is equal or more than the specified
  2100.               date.  However, only the HagScript commands will be
  2101.               halted, all other functions will function properly.
  2102.  
  2103.    EXAMPLES:  WAITDATE 08/23/89
  2104.               PRINT 1|1|Hi!
  2105.  
  2106.               (Waits till the date is August 23rd, after which it
  2107.               will display the string "Hi!")
  2108.  
  2109.  
  2110.  
  2111.                       -- HagScript Manual --                ( 32 )
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117. SPECIAL NOTES:   
  2118.                   
  2119. ------------------------------------------------------------------
  2120.  
  2121.     KEYWORD:  WAITTIMER
  2122.  
  2123.  PARAMETERS:  1) Timer string with the format HH:MM:SS
  2124.  
  2125. EXPLANATION:  Halts execution of further HagScript commands until
  2126.               the System Timer is equal or more than the specified
  2127.               timer.  However, only the HagScript commands will be
  2128.               halted, all other functions will function properly.
  2129.  
  2130.    EXAMPLES:  WAITTIMER 10:00:00
  2131.               PRINT 1|1|Hi!
  2132.  
  2133.               (Waits till the timer is 10 o'clock, after which it
  2134.               will display the string "Hi!")
  2135.  
  2136. SPECIAL NOTES:   
  2137.                  
  2138. ------------------------------------------------------------------
  2139.  
  2140.     KEYWORD:  TIMER
  2141.  
  2142.  PARAMETERS:  1) Timer status value
  2143.  
  2144. EXPLANATION:   Turns ON or OFF or TOGGLES the Timer.  A value of 0
  2145.                turns the Timer OFF; a value of 1 turns the Timer
  2146.                ON; a value of -1 TOGGLES the status of the Timer.
  2147.  
  2148.    EXAMPLES:  TIMER 1
  2149.  
  2150.               (Turns the Timer ON)
  2151.  
  2152. SPECIAL NOTES:   If you are in the Main Menu or Editor Mode, the
  2153.                  upper right hand clock will switch to Timer mode
  2154.                  and will display the Timer when you turn ON the
  2155.                  timer, and vice versa.
  2156.                  
  2157. ------------------------------------------------------------------
  2158.  
  2159.     KEYWORD:  LOADSCRIPT
  2160.  
  2161.  PARAMETERS:  1) Script filename
  2162.  
  2163. EXPLANATION:  Clears the current HagScript and loads in the
  2164.               specified HagScript.  It then automatically executes
  2165.               the new loaded HagScript.
  2166.  
  2167.    EXAMPLES:  LOADSCRIPT JUNGLE.HAG
  2168.  
  2169.               (Loads and executes the script "JUNGLE.HAG")
  2170.  
  2171. SPECIAL NOTES:   
  2172.                  
  2173. ------------------------------------------------------------------
  2174.  
  2175.  
  2176.  
  2177.                       -- HagScript Manual --                ( 33 )
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.     KEYWORD:  PLAY
  2184.  
  2185.  PARAMETERS:  none
  2186.  
  2187. EXPLANATION:  Re-Plays the current HagScript from the first
  2188.               command.
  2189.  
  2190.    EXAMPLES:  PLAY
  2191.  
  2192. SPECIAL NOTES:   
  2193.                  
  2194. ------------------------------------------------------------------
  2195.  
  2196.     KEYWORD:  SETMACRO
  2197.  
  2198.  PARAMETERS:  1) Macro number
  2199.               2) Macro String
  2200.  
  2201. EXPLANATION:  Defines the specified Macro number to the specified
  2202.               Macro string.  Macro number 1 is Macro F1, number 2
  2203.               is Macro F2, and so on.  Macro number 11 is
  2204.               Shift+F1, etc.
  2205.  
  2206.    EXAMPLES:  MACRO 3|This is Macro F3
  2207.      
  2208.               (Defines Macro F3 with the string "This is Macro
  2209.               F3")
  2210.  
  2211. SPECIAL NOTES:   
  2212.                  
  2213. ------------------------------------------------------------------
  2214.  
  2215.     KEYWORD:  AUXCLEAR
  2216.  
  2217.  PARAMETERS:  none
  2218.  
  2219. EXPLANATION:  Clears the Serial port buffer.
  2220.  
  2221.    EXAMPLES:  AUXCLEAR
  2222.  
  2223. SPECIAL NOTES:   This is similar to pressing ALT-X in the Terminal
  2224.                  Mode.
  2225.                  
  2226. ------------------------------------------------------------------
  2227.  
  2228.     KEYWORD:  SETTIME
  2229.  
  2230.  PARAMETERS:  1) Time strin in the format HH:MM:SS
  2231.  
  2232. EXPLANATION:  Sets the System Time to the specified Time.
  2233.  
  2234.    EXAMPLES:  SETTIME 15:05:30
  2235.  
  2236.               (Sets the system time to 15:05:30, or five past three
  2237.               and thirty seconds, P.M.)
  2238.  
  2239. SPECIAL NOTES:   
  2240.                  
  2241.  
  2242.  
  2243.                       -- HagScript Manual --                ( 34 )
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249. ------------------------------------------------------------------
  2250.  
  2251.     KEYWORD:  SETDATE
  2252.  
  2253.  PARAMETERS:  1) Date string in the format MM/DD/YY
  2254.  
  2255. EXPLANATION:  Sets the System Date to the specified Date.
  2256.  
  2257.    EXAMPLES:  SETDATE 08/12/89
  2258.  
  2259.               (Sets the date to August 12th, 1989)
  2260.  
  2261. SPECIAL NOTES:   
  2262.                  
  2263. ------------------------------------------------------------------
  2264.  
  2265.     KEYWORD:  LOADBUFFER
  2266.  
  2267.  PARAMETERS:  1) Filename
  2268.  
  2269. EXPLANATION:  Loads into the Buffer the specified file.
  2270.  
  2271.    EXAMPLES:  LOADBUFFER A:\HAGTERM.TXT
  2272.  
  2273.               (Loads the file A:\HAGTERM.TXT into the buffer)
  2274.  
  2275. SPECIAL NOTES:   
  2276.                  
  2277. ------------------------------------------------------------------
  2278.  
  2279.     KEYWORD:  UPPER
  2280.  
  2281.  PARAMETERS:  1) Variable name
  2282.  
  2283. EXPLANATION:  Capitalizes the specified Variable.
  2284.  
  2285.    EXAMPLES:  LET }A{|This is A TeST!
  2286.               UPPER }A{
  2287.               PRINT 1|1|}A{
  2288.  
  2289.               (Prints to the screen the string "THIS IS A TEST!")
  2290.  
  2291. SPECIAL NOTES:   This is similar to GFA Basic's UPPER$() command.
  2292.                  
  2293. ------------------------------------------------------------------
  2294.  
  2295.     KEYWORD:  DCOPY
  2296.  
  2297.  PARAMETERS:  none
  2298.  
  2299. EXPLANATION:  Executes the DCOPY program under the filename
  2300.               specified in the Defaults.
  2301.  
  2302.    EXAMPLES:  DCOPY
  2303.  
  2304. SPECIAL NOTES:   
  2305.                  
  2306. ------------------------------------------------------------------
  2307.  
  2308.  
  2309.                       -- HagScript Manual --                ( 35 )
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.     KEYWORD:  UPLOAD
  2317.  
  2318.  PARAMETERS:  1) Protocol to use:
  2319.                     1 - Xmodem         2 - Xmodem 1K
  2320.                     3 - Ymodem Batch   4 - ASCII
  2321.  
  2322.               2) File to upload
  2323.  
  2324. EXPLANATION:  Uploads a specified file using a specified protocol
  2325.  
  2326.    EXAMPLES:  UPLOAD 2|HAGTERM3.PRG
  2327.  
  2328.               (Uploads the file "HAGTERM3.PRG" using Xmodem 1K)
  2329.  
  2330. SPECIAL NOTES:   
  2331.                  
  2332. ------------------------------------------------------------------
  2333.  
  2334.     KEYWORD:  DOWNLOAD
  2335.  
  2336.  PARAMETERS:  1) Protocol to use:
  2337.                     1 - Xmodem          2 - Xmodem 1K
  2338.                     3 - Ymodem Batch
  2339.  
  2340.               2) Filename/path to download
  2341.  
  2342. EXPLANATION:   Downloads a file under specified filename using the
  2343.               specified protocol.
  2344.  
  2345.    EXAMPLES:  DOWNLOAD 3|A:\*.*
  2346.  
  2347.               (Downloads files using Ymodem Batch onto drive A:)
  2348.  
  2349. SPECIAL NOTES:   
  2350.                  
  2351. ------------------------------------------------------------------
  2352.  
  2353.     KEYWORD:
  2354.  
  2355.  PARAMETERS:
  2356.  
  2357. EXPLANATION:
  2358.  
  2359.    EXAMPLES:
  2360.  
  2361. SPECIAL NOTES:   
  2362.                  
  2363. ------------------------------------------------------------------
  2364.  
  2365.     KEYWORD:
  2366.  
  2367.  PARAMETERS:
  2368.  
  2369. EXPLANATION:
  2370.  
  2371.    EXAMPLES:
  2372.  
  2373.  
  2374.  
  2375.                       -- HagScript Manual --                ( 36 )
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381. SPECIAL NOTES:   
  2382.                  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.                       -- HagScript Manual --                ( 37 )
  2442.  
  2443.